home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / fatal13.arc / FATAL.DOC < prev    next >
Encoding:
Text File  |  1989-08-30  |  6.8 KB  |  197 lines
  1.  
  2.                               F A T A L
  3.                    Resident Critical Error Handler
  4.  
  5.                              FATAL13.ZIP
  6.                              v1.3 8-14-89
  7.  
  8.                     Copyright 1989 Samuel H. Smith
  9.                           All rights reserved.
  10.  
  11.  
  12. This program is a resident (TSR) utility that traps critical errors and
  13. attempts to handle them in an intelligent way.  It replaces the normal
  14. "Retry, Ignore, Abort" prompt.
  15.  
  16. It draws on all available information to present a complete error
  17. description to the user.  If the operator does not respond within 30
  18. seconds the program will automatically take the action suggested by DOS.
  19.  
  20. DOS version 3.0 or later is required to use this program.
  21. Once resident, FATAL used about 3800 bytes of RAM.
  22.  
  23.  
  24. Usage:
  25.    FATAL/I     ;install FATAL in memory.
  26.  
  27.    FATAL/U     ;un-install, remove FATAL from memory.
  28.  
  29.    FATAL/C     ;display critical error counters.
  30.  
  31.  
  32.  
  33. The FATAL program will take over critical errors that are not directly
  34. handled in a later program.  It is careful to preserve any replacement
  35. error handler used by an application program.  Because of this, it is
  36. advised to load FATAL as an early TSR, before any others that also set
  37. up critical error handlers.  In multi-tasking systems you may need to
  38. load a copy of FATAL into each memory partition.
  39.  
  40.   NOTE: If you are running the LANtastic network, you must load FATAL
  41.         *before* calls to SERVER and probably also before REDIR and
  42.         LANBIOS. Otherwise a sharing violation will be trapped on the
  43.         server rather than on the offending workstation!
  44.  
  45. Example output
  46. --------------
  47.  
  48. FATAL/I
  49.    FATAL v1.3 installed.
  50.  
  51. FATAL/U
  52.    FATAL unInstalled.
  53.  
  54. FATAL/C
  55.    FATAL v1.3 status:
  56.       10 Critical errors.
  57.        5 Automatic retries.
  58.    Error:
  59.        3 Seek error!
  60.        6 Sharing violation!
  61.        1 Network device no longer exists!
  62.    Class:
  63.        3 Hardware failure
  64.        6 Resource locked
  65.        1 Unknown
  66.    Locus:
  67.        1 Unknown.
  68.        8 Block device (disk error).
  69.        1 Network.
  70.    Drive:
  71.        2 I:
  72.        6 J:
  73.        2 U:
  74.    Area:
  75.        5 Directory area.
  76.        5 Data area.
  77.    Suggested action:
  78.        3 Retry the operation.
  79.        6 Delay and then retry.
  80.        1 Re-enter input.
  81.  
  82.  
  83.   ╔═══════════════════╡ CRITICAL ERROR! ╞════════════════════╗                  
  84.   ║  Error: Drive not ready!                                 ║                  
  85.   ║  Area:  Reading from drive A: File allocation table.     ║                  
  86.   ║  Class: Hardware failure in Block device (disk error).   ║                  
  87.   ║  Suggested action: Retry after correcting the error.     ║                  
  88.   ╚══════════════════════════════════════════════════════════╝                  
  89.      Action: (A)bort, (R)etry, (I)gnore, (F)ail? <R>
  90.  
  91.  
  92.                                    LICENSE
  93.                                    =======
  94.  
  95.    SourceWare: What is it?
  96.    -----------------------
  97.  
  98.    SourceWare is my name for a unique concept in user supported
  99.    software.
  100.  
  101.    Programs distributed under the SourceWare concept always offer source
  102.    code.
  103.  
  104.    This package can be freely distributed so long as it is not modified 
  105.    or sold for profit.  If you find that this program is valuable, you
  106.    can send me a donation for what you think it is worth.  I suggest
  107.    about $10.
  108.  
  109.    Send your registrations to:        The Tool Shop BBS
  110.       Samuel H. Smith                 (602) 264-3969 (2400) - Free node
  111.       5119 N. 11th Ave., #332         (602) 279-2673 (HST 9600)
  112.       Phoenix AZ 85013                (602) 279-0230 (HAYES 9600)
  113.  
  114.  
  115.    Why SourceWare?
  116.    ---------------
  117.    Why do I offer source code?  Why isn't the donation manditory?  The
  118.    value of good software should be self-evident.  The source code is
  119.    the key to complete understanding of a program.  You can read it to
  120.    find out how things are done.  You can also change it to suit your
  121.    needs, so long as you do not distribute the modified version without
  122.    my consent.
  123.  
  124.  
  125.    Copyright
  126.    ---------
  127.    If you modify this program,  I would appreciate a copy of the new
  128.    source code.  I am holding the copyright on the source code,  so
  129.    please don't delete my name from the program files or from the
  130.    documentation.
  131.  
  132.  
  133.                                 DISCLAIMER
  134.                                 ==========
  135.    I make no warranty of any kind, express or implied, including without
  136.    limitation, any warranties of merchantability and/or fitness for a
  137.    particular purpose.  I shall not be liable for any damages, whether
  138.    direct, indirect, special or consequential arising from a failure of
  139.    this program to operate in the manner desired by the user.  I shall
  140.    not be liable for any damage to data or property which may be caused
  141.    directly or indirectly by the use of this program.
  142.  
  143.    IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY
  144.    LOST PROFITS,  LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL
  145.    DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR
  146.    FOR ANY CLAIM BY ANY OTHER PARTY.
  147.  
  148.  
  149.  
  150. Revision History
  151. ----------------
  152.  
  153. 7-20-89 v1.0
  154.    Initial coding and release.
  155.  
  156. 7-31-89 v1.1
  157.    Changed all display code to use BIOS calls exclusively.  The initial
  158.    version used the DOS function 9, but this caused problems when
  159.    standard output was redirected: the FATAL messages were also
  160.    redirected!
  161.  
  162.    Added screen save and restore operations; original user screen is now
  163.    preserved after fatal error processing (text modes only).  BIOS calls
  164.    are used for compatibility with all system types.
  165.  
  166.    Corrected an error that caused application program error handlers to
  167.    be replaced.  FATAL is supposed to replace only the standard handler,
  168.    leaving application error handlers in place.
  169.  
  170. 8-2-89 v1.2
  171.    Changed keyboard input functions to use BIOS calls rather than DOS
  172.    calls.  This prevents a crash if standard input has been redirected
  173.    from a file at the time a critical error takes place.
  174.  
  175.    Slight reduction in RAM requirement.
  176.  
  177.    FATAL now removes itself from memory if run a second time.  Please
  178.    don't do this if you have any resident programs loaded after FATAL.
  179.  
  180.    Added /L command line option to bypass license messages.
  181.  
  182. 8-14-89 v1.3
  183.    Added internal counters for number if critical errors and number of
  184.    automatic retries.  Each possible error message is counted for later
  185.    reporting.
  186.  
  187.    New FATAL/C option produces a detailed report of all error counters.
  188.  
  189.    New FATAL/I option performs initial installation.
  190.  
  191.    New FATAL/U option un-installs fatal if possible.
  192.  
  193.    Fatal now hooks the DOS services interrupt in addition to the timer
  194.    tick interrupt.  On very fast machines it was possible to miss a
  195.    critical error during the first 18.2 miliseconds of program
  196.    execution.
  197.